home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / wp / flex251x.zip / FLEX251 / README.BCC < prev   
Text File  |  1995-04-13  |  5KB  |  134 lines
  1. README flex 2.5.1 - Borland 4.02 distribution
  2. ----------------------------------------------------------------
  3. enclosed in flex251s.zip (source) and flex251x.zip (executable)
  4. ----------------------------------------------------------------
  5.  
  6. This is the dos distribution of flex 2.5.1 compiled with Borland
  7. 4.02.
  8.  
  9. The .exe that I'm distributing is compiled without debug this time,
  10. and thus it's smaller!
  11.  
  12. Using "makefile" and "config.h" enclosed source archive (in the
  13. flex251/borland directory) this was a straightforward compile,
  14. requiring no changes to the flex source code.  Those two files are
  15. the only changes to the official unix'ish flex distribution, and
  16. are included in the official distribution.
  17.  
  18. (I distribute these archives 'cause I'm a nice guy :-)
  19.  
  20. I have not tested this executable extensively, so caveat emptor.
  21. I did test earlier *beta* versions fairly well, and they passed
  22. with flying colors.
  23.  
  24. As followup to the notes for my port of version 2.4.7, the c++
  25. testing went without a hitch.  Also, the memory limitations on
  26. flex itself (not the generated scanner) remain.  (This is _still_
  27. dos, y'know what I mean?)
  28.  
  29. The current archives' contents is roughly equivalent to the
  30. flex247(s,x) archive files. E.G. you get everything that you need,
  31. including a bison'ed parser in parse.c, using the Andrew version of
  32. bison from Carnegie-Mellon University (my preferred version, btw.)
  33.  
  34. [ plug for bison-a23: it's not encumbered by the FSF copyleft!
  35.   it has good C++ support including a runtime parser class that
  36.   uses tables generated by bison-a23!  once more, it's FREE!
  37.   Thanks Wilfred.Hansen!
  38.  
  39.   One of these days, I'll get around to posting my dos port,
  40.   but don't hold your breath :-(  I still haven't finished
  41.   working on my integration of the bison-a23 parser class with
  42.   the flexlexer class :-(  The real job comes first, y'know.
  43.  
  44.   for the source to this bison, get
  45.   ftp://ftp.andrew.cmu.edu/pub/AUIS/bison/bison-A2.3.tar.gz
  46. ]
  47.  
  48. For people with problems:
  49.  
  50.     Use your debugging skills, or those of someone that you
  51.     work with, before firing off an email to me.  This distribution
  52.     of flex for *DOS* is not missing anything that you need, and
  53.     works for all tests.
  54.  
  55.     Look to the examples in the Nutshell lex/yacc book for
  56.     help in understanding lex/yacc.
  57.  
  58.     Use a symbolic debugger, and step through your code.  You
  59.     might find that you're passing a char* instead of a char
  60.     to a function.
  61.  
  62.     If your generated scanner blows up, DEBUG.  This distribution
  63.     of flex is (gee) still a dos 16-bit application.
  64.  
  65. (I have received very few "problem reports" that weren't solved
  66. by a tiny amount of good, honest debugging. ;-)
  67.  
  68. If this debugging fails, you can try sending me mail, but I don't
  69. promise to keep this address forever, nor to followup on your
  70. questions :-)  I try to answer dos/flex related questions, but it's
  71. not my job, and *that* comes first.
  72.  
  73. With that in mind, happy flexing!
  74.  
  75.  
  76.  
  77.  
  78. README flex 2.4.7 - Borland 4.02 distribution
  79. ----------------------------------------------------------------
  80. enclosed in flex247s.zip (source) and flex247x.zip (executable)
  81. ----------------------------------------------------------------
  82.  
  83. This flex (2.4.7) executable was compiled with, and generates code
  84. that is successfully compiled with Borland C/C++ 4.02
  85.  
  86. A limitation is that very large scanner input files (that is to say,
  87. a very large number of actions) may cause the flex to terminate while
  88. trying to reallocate a buffer greater than 64 KB of memory.  This
  89. could in fact be worked around by using a far memory allocation
  90. routine at the expense of source code portability.  I chose to remain
  91. ansi-c compatible - the only scanner input that I've seen venture
  92. close to this is the scanner for flex itself.
  93.  
  94. The enclosed flex.skl is the same as the hard-coded skeleton; it
  95. compiles cleanly with borland as a standalone c file or as a c file
  96. included within 'extern "C" {...}' in a c++ file.  I have not yet
  97. tried out a true c++ generated scanner (with the '-+' option) but
  98. expect to do so soon (*and* expect not to have any problems (thanks
  99. vern)).  But I *will* advise and repost any additional patches that
  100. might prove to be necessary.
  101.  
  102. Installation for DOS: copy the executable into a directory on your
  103. path. That's it.
  104.  
  105. The archive file (flex247x.zip) includes
  106.  
  107. flex.exe    executable
  108. flex.skl    the skeleton that you can modify to suit yourself
  109. flex.1        nroff source for the man page
  110. flexdoc.1    nroff source for the manual
  111. flex.man    the man page formatted
  112. flexdoc.man    the manual formatted
  113. copying        read this
  114. news        release notes
  115. readme        Vern's original readme
  116. readme.bcc    this file
  117. bccdiffs    (unified) context diffs for the distribution sources
  118. makefile    a makefile for BCC 4.02, using Borland's make
  119.  
  120. The archive file (flex247s.zip) includes
  121.  
  122. all the above files (except the executable, of course,) and all
  123. files include in the original distribution archive.  Ths sources in
  124. the directory are those that have been patched for compilation with
  125. bcc.  If you want the originals, you probably know where to find 'em
  126. - and I expect that you could recreate them from the diffs :-)
  127.  
  128. Have fun.
  129.  
  130. Terry Kane
  131. tkane01@eagle.cc.emory.edu
  132.  
  133. Bugs lurk in corners and congregate at boundaries.  (Bezier)
  134.